home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 65.zip / BS1 part 65 / Delitracker v1.21.adf / Docs / DeliTracker.dok < prev    next >
Text File  |  1992-05-17  |  26KB  |  739 lines
  1.  
  2.  
  3.  
  4. **********************************************************************
  5. *                 DeliTracker V1.21                 *
  6. **********************************************************************
  7.  
  8.  
  9.                 © 1992 by Delirium
  10.                  Datum 15.05.1992
  11.  
  12.  
  13.  
  14. =============================== DISCLAIMER ===========================
  15.  
  16.              DeliTracker (c) by Peter Kunath und Frank Riffel.
  17.  
  18. Diese Version von DeliTracker ist frei vertreibbar, solange folgende
  19. Bedingungen eingehalten werden:
  20.  
  21. Programm, Dokumentation und alle anderen Files dürfen nur in ihrem
  22. Orginalzustand weitergegeben werden. Selbstverständlich dürfen Sie
  23. ein Archivierungsprogramm wie LHArc verwenden um die Demoversion
  24. Mailboxen und FTP Servern zugänglich zu machen. Das Programm darf
  25. nicht ohne schriftliche Einwilligung der Autoren kommerziell genutzt
  26. werden. Für die Diskette, auf der sich diese Version befindet, darf
  27. nicht mehr als 8,- DM verlangt werden. Die Autoren übernehmen keinerlei
  28. Haftung für Schäden, die durch die Benutztung dieses Programms entstehen.
  29.  
  30.  
  31. Wenn sie die Vollversion von DeliTracker haben wollen schicken Sie
  32.  
  33.     DM20    wenn Sie in Deutschland wohnen
  34.     $US20    wenn Sie außerhalb Deutschlands wohnen
  35.  
  36. (nur bar, keine Schecks) zusammen mit der ausgefüllten Registrierkarte
  37. an die folgende Adresse:
  38.  
  39.     Frank Riffel
  40.     Merkstr.27
  41.     8129 Wessobrunn
  42.     Germany
  43.  
  44.  
  45. ========================== Was ist DeliTracker ? =====================
  46.  
  47. DeliTracker ist ein Soundplayer, der viele verschiedene Soundformate
  48. abspielen kann. Soundtracker 15 inst., SoundTracker 31inst., NoiseTracker,
  49. ProTracker, StarTrekker ohne AM sounds und CustomPlay sind interne Player,
  50. zusätzliche können von Disk nachgeladen werden. Das bedeutet, daß man sehr
  51. schnell, einfach und bequem neue Player hinzufügen kann.
  52.  
  53.  
  54. ======================= Was DeliTracker nicht ist ! ==================
  55.  
  56. Bei DeliTracker handelt es sich nicht um einen Songeditor, MIDIsequenzer
  57. oder Digitizer. Er ist ausschließlich dazu gedacht, komfortabel Musik
  58. abzuspielen.
  59.  
  60.  
  61. ================== Wieso gerade DeliTracker benutzen ? ===============
  62.  
  63.     ° läuft zuverlässig im Multitasking
  64.     ° belegt die Soundkanäle
  65.     ° hat ein ARexx - Interface
  66.     ° korrekte Abspielgeschwindigkeit auch auf NTSC-Geräten
  67.     ° verträgt sich mit dem serial.device
  68.     ° unterstützt mit PowerPacker und Imploder gecrunchte Soundfiles
  69.     ° verwaltet bis zu 64 Player
  70.     ° läuft unter Kickstart 2.0 und auf Turbokarten
  71.     ° benutzt req.library
  72.     ° hat ein Configurationsfile
  73.     ° enforcer und mungwall getestet
  74.     ° volle Unterstützung von CLI und Workbench (Tooltypes)
  75.     ° kinderleichte Bedienung durch ansprechende Oberfläche
  76.     ° Volume/Balance - Regler
  77.     ° Mulitselect von Files
  78.     ° Resident Startup vom CLI
  79.     ° wurde zu 100% in Assembler geschrieben
  80.     ° ... und ist von Delirium Softdesign programmiert
  81.  
  82.  
  83. ============================ Voreinstellungen ========================
  84.  
  85. Start von DeliTracker
  86.  
  87. DeliTracker kann durch die zusätzliche Angabe von folgenden Optionen beim
  88. Start individuell konfiguriert werden:
  89.  
  90. Option                    Voreinstellung und Beschreibung
  91. -------------------    -------------------------------
  92.  
  93. config <Datei>        'ENV:DeliTracker.config'
  94.             Lädt die angegebene Datei als Konfigurationsdatei.
  95.  
  96. module <Datei>        Keine Datei bzw. die Modulliste ist leer.
  97.             Fügt die angegebene Datei in die Modulliste ein.
  98.  
  99. playerpath <Pfad>    'DeliPlayers'
  100.             Legt den Pfad fest, aus dem DeliTracker die externen
  101.             Player nachlädt.
  102.  
  103. windowxy<XPos>/<YPos>    0/0
  104.             Das Kontrollfenster wird an der neuen Position
  105.             geöffnet. Wenn das nicht gelingt, öffnet sich das
  106.             Fenster bei 0/0.
  107.  
  108. prefwinxy<XPos>/<YPos>    0/1
  109.             Das Setupfenster wird an der gewünschten Position
  110.             geöffnet. Schlägt dies fehl, öffnet sich das Fenster
  111.             bei 0/1.
  112.  
  113. volume    <Volume>    64 (volle Lautstärke)
  114.             Setzt die Lautstärke auf den angegebenen Wert. Werte
  115.             werden im Bereich von 0 bis 64 akzeptiert.
  116.  
  117. balance <Balance>    0 (ausgewogene Balance)
  118.             Die Balance wird auf den angegebenen Wert gesetzt.
  119.             Werte von -64 (nur links) bis 64 (nur rechts) sind
  120.             gültig.
  121.  
  122. reqlines <Nummer>    0 (Standardeinstellung des Requesters)
  123.             Legt die Anzahl der Zeilen im Filerequester fest.
  124.  
  125. subsong <Nummer>    0 bzw. erster Subsong
  126.             Falls das erste Modul in der Liste Subsongs unter-
  127.             stützt, wird nicht der erste sondern der angegebene
  128.             Subsong gespielt.
  129.  
  130. playing <Bool>        1 bzw. Modul wird geladen
  131.             Legt fest, ob nach dem Start das erste Modul in der
  132.             Liste geladen werden soll.
  133.  
  134. window <Bool>        1 bzw. Fenster offen
  135.             Legt fest, ob das Kontrollfenster überhaupt geöffnet
  136.             wird. Das Öffnen des Fensters kann nur unterdrückt
  137.             werden, wenn der AREXX-Server läuft.
  138.  
  139. filter <Bool>        0 bzw. Filter aus
  140.             Schaltet den Amiga-internen Tiefpassfilter ein oder
  141.             aus. Es ist von Vorteil, den Filter abgeschaltet zu
  142.             lassen, da dann Frequenzen über 7 kHz nicht mehr aus-
  143.             gefiltert werden, was zu einer merklichen Klang-
  144.             verbesserung führt.
  145.             (Dieser Schalter ist beim Amiga 1000 ohne Wirkung !)
  146.  
  147. quick <Bool>        1 bzw. Modul wird sofort gespielt
  148.             Legt fest, ob ein Modul sofort nach dem Laden oder
  149.             erst nach explizitem Play (Gadget/Shortcut/ARexx) abgespielt
  150.             wird. Diese Option ist hauptsächlich zur Synchronisation
  151.             in ARexx-Scripts gedacht.
  152.  
  153. random <Bool>        0 bzw. sequentielle Reihenfolge
  154.             Legt fest, ob bei einer Next/Prev-Song Aktion das
  155.             nachfolgende bzw. vorhergehende oder ein zufällig
  156.             ausgewähltes Modul der Liste gespielt wird. Diese
  157.             Option ist nur sinnvoll bei mehr als zwei Modulen
  158.             in der Modulliste.
  159.  
  160. append <Bool>        0 bzw. die Modulliste wird vor jedem Sektieren gelöscht
  161.             Legt fest, ob bei jeder Fileauswahl eine neue Liste
  162.             angelegt werden soll oder die Liste am Ende erweitert
  163.             wird. Damit ist dann ein Multiselect über mehrere
  164.             Directorys möglich.
  165.  
  166. songend <Bool>        0 bzw. kein Beachten des Songendes
  167.             Legt fest, ob das Songende beachtet wird oder nicht.
  168.             Einige Player können DeliTracker signalisieren, wenn
  169.             das aktuelle Modul einmal komplett gespielt wurde.
  170.             Ist diese Option aktiv, beachtet DeliTracker das
  171.             Songende, d.h. das aktuelle Modul wird gestoppt und
  172.             dann eine NextSong Aktion ausgelöst. Bei nur einem
  173.             Modul in der Songliste wird dies nur gestoppt.
  174.  
  175. timeout <Nummer>    0 bzw. kein Timeout
  176.             Legt die Zeitspanne (in Sekunden) fest, die ein
  177.             Modul spielt. Danach wird eine NextSong Aktion
  178.             ausgelöst. Bei 0 ist diese Funktion abgeschaltet.
  179.  
  180. Die Groß- oder Kleinschreibung der Optionen ist unwichtig !
  181.  
  182.  
  183.  
  184. Start vom CLI bzw. von der Shell.
  185.  
  186. Öffnen sie ein CLI- oder Shellfenster und gehen Sie mittels des 'CD'-Befehls
  187. in das Verzeichnis, in dem sich DeliTracker befindet. Geben Sie jetzt
  188. 'DeliTracker' ein (ohne die Hochkommata !) und drücken Sie die Return-Taste.
  189. DeliTracker wird nun geladen und gestartet. Da DeliTracker sich selbst vom CLI
  190. löst, muß er nicht mit 'run' oder 'runback' gestartet werden, um das das CLI-
  191. Window wieder schließen zu können. Alle oben erklärten Optionen können beim
  192. Start angegeben werden.
  193.  
  194. z.B. 'DeliTracker config DT.config reqlines 18 volume 32 filter 1'
  195.  
  196. Bei falschen Eingaben oder ungültigen Optionen wird ein Hilfstext ausgegeben.
  197.  
  198.  
  199.  
  200. Start von der Workbench
  201.  
  202. Öffnen Sie den Ordner, in dem sich DeliTracker befindet und starten Sie das
  203. Programm durch einen Doppelklick auf dessen Icon.
  204. Mit dem 'Info'-item aus dem Workbench- bzw. Iconmenu (je nach Kickstart)
  205. können alle oben erklärten Optionen als ToolTypes eintragen. Dabei ist
  206. jedoch zu beachten, daß die Optionen von den Argumenten durch '=' getrennt
  207. werden.
  208.  
  209. z.B.    Config=DT.config
  210.         PrefWinXY=0/11
  211.         Volume=43
  212.         Window=0
  213.  
  214. Ungültige Optionen werden beim Start von der Workbench ignoriert.
  215. DeliTracker kann natürlich auch als 'Default Tool' angegeben werden.
  216.  
  217.  
  218.  
  219. Das Konfigurationsfile
  220.  
  221. Ein Konfigurationsfile ist eine Datei, in der mehrere Optionen mit den
  222. gewünschten Argumenten aufgefürt sind. Dabei ist zu beachten, daß die
  223. 'config'-Option als einzige nicht benutzt werden kann. Pro Zeile darf
  224. nur eine Option verwendet werden. Kommentare beginnen mit ';'. Eine
  225. Konfigurationsdatei kann entweder mit den Save Optionen aus dem Setup-
  226. Fenster oder manuell ertstellt werden. Mit Hilfe von NewList können sich
  227. Besitzer großer Modulverzeichnisse eine Modulliste eines kompletten
  228. Directorys erstellen. Tagen Sie dazu folgende Zeile in Ihre Shell-Startup
  229. ein: 'alias ModList NL -hTigfsF "module=\'%P\'" []'. Der Output muß nur
  230. noch in eine Datei ungeleitet werden.
  231.  
  232. Beispiel für eine Konfigurationsdatei:
  233.  
  234. ; Mein erstes Konfig(sm|f)ile
  235. windowxy=473/15
  236. random=1
  237. songend=1
  238. timeout=300
  239. reqlines=50
  240. subsong=2
  241. playerpath="Data:DeliPlayers"
  242. ;
  243. ; Hier kommen die Module
  244. ;
  245. module="Data:Modules/SonicArranger/MF__Slowmotion1.3.pp"
  246. module="Data:Modules/FutureComposer13/hidden part.pp"
  247.  
  248.  
  249. Beim Start von DeliTracker haben die Optionen von CLI und Workbench Priorität
  250. über ein Konfigurationsfile, d.h. die Einstellungen im Konfigurationsfile
  251. werden dann durch die angegebene Option ersetzt.
  252.  
  253. Bei Programmstart versucht DeliTracker das Konfigurtionsfile
  254. 'ENV:DeliTracker.config' zu öffnen. Ist diese Datei vorhanden, übernimmt
  255. DeliTracker alle angegebenen Einstellungen daraus. Er lädt dann die externen
  256. Player sowie das Modul und spielt es. Ist keine Konfigurationsdatei vorhanden,
  257. so wird versucht, externe Player aus dem Verzeichnis 'Deliplayers'
  258. (im aktuellen Pfad) nachzuladen. Ist dieses Directory auch nicht vorhanden,
  259. stehen dem Benutzer nur die internen Player zur Verfügung.
  260.  
  261.  
  262. =============================== PLAYER ===============================
  263.  
  264. Unterstützte Soundformate:
  265.  
  266.     ° ProTracker/NoiseTracker/SoundTracker15/SoundTracker31/ und
  267.       StarTrekker mit und ohne AM Sounds. INTERN
  268.  
  269.     ° CustomPlay für spezial Module, die ihren Player beinhalten
  270.       (diese 'Module' dürfen nicht gepackt werden, weil sie mit
  271.       LoadSeg() geladen werden um eine Relozierung zu ermöglichen)
  272.  
  273.     ° Alle externen Player sind in Player.dok aufgelistet.
  274.  
  275.  
  276. ============================= gepackte Module ========================
  277.  
  278. DeliTracker erkennt und entpackt automatisch mit PowerPacker und Imploder
  279. gecrunchte Files.
  280. Hinweis: Custommodule dürfen nicht gepackt werden, da sie im Gegensatz zu
  281. normalen Files nicht mit Read() sondern mit LoadSeg() geladen werden
  282. (Relozierung des Playercodes) !
  283.  
  284. Ob Sie Soundmodule packen dürfen, können Sie im PlayerInfo-Feld erfahren.
  285. Wenn dort 'Packable....YES' steht, unterstützt der jeweilige Player mit
  286. größter Wahrscheinlichkeit mit PowerPacker gepackte Module. Zumindest
  287. kann in JEDEM Fall das von Ihnen angewählte File gepackt werden. Werden
  288. weitere Dateien nachgeladen, dürfen Sie diese möglicherweise nicht mehr
  289. packen. Bei 'Packable....NO' darf das Soundmodule auf keinen Fall gepackt
  290. werden oder es wird von DeliTracker nicht mehr erkannt.
  291.  
  292.  
  293. ============================== Kickstart 2.0 =========================
  294.  
  295. Die Version für Kickstart 2.0 unterscheidet sich in folgenden Punkten
  296. von der für Kickstart 1.3:
  297.  
  298.     ° die Farben sind an Kick 2.0 angepaßt
  299.     ° das Kontrollfenster besitzt ein Zip-Gadget
  300.     ° Module können auch gespielt werden, indem ihr Icon in das
  301.       Kontrollfenster abgelegt wird (Appwindow).
  302.  
  303.  
  304. ================================= Gadgets ============================
  305.  
  306. Wenn bestimmte Gadgets gerastert dargestellt werden, ist für den
  307. aktuellen Player diese Option nicht verfügbar. Das kann zum einen
  308. bedeuten, daß die Funktion vom Player gar nicht unterstützt wird
  309. (wie z.B Subsongs bei SoundTracker) oder zum anderen, daß der Player
  310. noch nicht optimal angepaßt ist.
  311.  
  312.     +----------+--+-------------------------------------------------------+--+
  313.     |          |  |                                                    [] |  | [15]
  314. [1] | ?        +  +-------------------------------------------------------+  +
  315.     |          |  |                               []                      |  | [14]
  316.     +---+------+--+--+------+------+------+-----+------+------+-----+-----+--+
  317. [2] | + |      |     |      |      |      |     |      |      |     |  |¯¯\  |
  318.     +---+  |<  |  <  |  <<  |  |>  |  >>  |  >  |  >|  |  []  |  ^  |  |  |  |
  319. [3] | - |      |     |      |      |      |     |      |      |  ¯  |  +--+  |
  320.     +---+------+-----+------+------+------+-----+------+------+-----+--------+
  321.           [4]    [5]    [6]   [7]    [8]    [9]   [10]   [11]   [12]   [13]
  322.  
  323.   [1]    öffnet bzw. schließt das Setupwindow (Beschreibung siehe unten)
  324.  
  325.   [2]    Faster: erhöht die Abspielgeschwindigkeit des aktuellen Musikstücks
  326.  
  327.   [3]    Slower: vermindert die Abspielgeschwindigkeit des aktuellen Stücks
  328.  
  329.   [4]    Prev Song: wenn nur ein File angewählt wurde und der Song mit kill
  330.            entfernt wurde, wird er wieder eingeladen. Sind mehrere
  331.            Files selektiert, wird der Vorgänger des aktuellen Songs
  332.            eingeladen.
  333.  
  334.   [5]    Prev Subsong: spielt den vorherigen Subsong.
  335.  
  336.   [6]    Backward: der aktuelle Patternzeiger wird auf das vorherige Pattern
  337.           gesetzt. Wird gerade das erste Pattern gespielt, wird er
  338.           auf das letzte gesetzt.
  339.  
  340.   [7]    Play/Pause: startet einen gepausten bzw. gestoppten Sound / hält
  341.             einen gerade spielenden Song an.
  342.  
  343.   [8]    Forward: der aktuelle Patternzeiger wird auf das nachfolgende Pattern
  344.          gesetzt. Wird gerade das letzte Pattern gespielt, wird er
  345.          auf das erste gesetzt.
  346.  
  347.   [9]    Next Subsong: spielt den nächsten Subsong.
  348.  
  349.  [10]    Next Song: bei nur einem angewählten File wie bei 'Prev Song', sonst
  350.            wird der Nachfolger des aktuellen Songs eingeladen.
  351.  
  352.  [11]    Stop Song: setzt die Abspielgeschwindigkeit und den Patternzeiger auf
  353.            den Startwert zurück.
  354.  
  355.  [12]    Kill Song: stoppt den aktuellen Song und entfernt ihn aus dem Speicher.
  356.  
  357.  [13]    Load Song: öffnet den Filerequester. Wenn beim Auswählen die SHIFT-
  358.            Taste gehalten wird, können mehrere Files angewählt werden.
  359.            Diese werden dann in eine zyklische Liste eingetragen. Nach
  360.            Verlassen des Requesters wird der erste ausgewählte Song
  361.            geladen und gespielt. Alle weiteren können über 'Next Song'
  362.            bzw. 'Prev Song' erreicht werden. Falls genügend Speicher
  363.            vorhanden ist, wird der aktuell spielende Song erst gestoppt,
  364.            wenn der angewählte komplett geladen wurde. Diese eingebaute
  365.            Doublebuffering-Routine sorgt speziell bei Floppybesitzern
  366.            für Dauersoundgenuß.
  367.  
  368.  [14]    Balance-Regler: dieses Gadget dient zur Einstellung der Balance.
  369.  
  370.  [15]    Volume-Regler:    Gadget für die Lautstärke Einstellung.
  371.  
  372.  
  373. ================================ Shortcuts ===========================
  374.  
  375. Die meisten Funktionen von DeliTracker lassen sich mittels Shortcut aufrufen.
  376. Um die Shortcuts möglichst einprägsam zu machen, wurden sie im Mainwindow
  377. den Zeichen auf dem Ziffernblock zugeordnet b.z.w. im Setupfenster mit dem
  378. Anfangsbuchstaben der dazugehörigen Funktion belegt. Ausnahmen sind lediglich
  379. Songend und Append, da hier bereits der Anfangsbuchstabe belegt war.
  380.  
  381.  
  382. Für das Mainwindow existieren folgende Shortcuts:
  383.  
  384. /    - öffnet Setupwindow
  385.  
  386. *    - Filerequester zum Modulladen öffnen
  387.       (SHIFT gedrückt halten, um mehrere Files anzuwählen)
  388.  
  389. 0    - Play/Pause (spielen bzw. anhalten der Musik)
  390.  
  391. 1    - Stop Song (Song anhalten, Patternzeiger auf Anfang setzen)
  392.  
  393. +    - erhöht Abspielgeschwindigkeit
  394.  
  395. -    - erniedrigt        -"-
  396.  
  397. 5    - Patternzeiger auf nächstes Pattern setzen
  398.  
  399. 6    - Patternzeiger auf vorheriges Pattern setzen
  400.  
  401. ] und )    - nächsten angewählten Song spielen
  402.  
  403. [ und (    - Vorgängersong spielen
  404.       (nur wenn mehrere Files angewählt wurden)
  405.  
  406. 8    - nächsten Subsong spielen
  407.  
  408. 7    - vorherigen    -"-
  409.  
  410. .    - Song anhalten und seinen Speicher freigeben
  411.  
  412. 9    - erniedrigt die Lautstärke
  413.  
  414. 6     - erhöht die Lautstärke
  415.  
  416. 2    - verändert die Balance so, das der linke Kanal lauter wird.
  417.  
  418. 3    - verändert die Balance so, das der rechte Kanal lauter wird.
  419.  
  420.  
  421.  
  422. Für das Setupwindow existieren folgende Shortcuts:
  423.  
  424. f    - Filterzustand
  425.  
  426. q    - Quickstart
  427.  
  428. r    - Randommodus
  429.  
  430. e    - SongEnd
  431.  
  432. p    - Append
  433.  
  434. t    - Time Gadget akitivieren
  435.  
  436. a    - Filerequester zu Playerladen öffnen
  437.  
  438. d    - selektierten Player entfernen
  439.  
  440. l    - Konfiguartionsdatei mittels Filerequester laden
  441.  
  442. s    - Konfiguartionsdatei mittels Filerequester speichern
  443.  
  444. c    - selektierten Player konfigurieren (wenn möglich)
  445.  
  446. o    - Setupwindow verlassen
  447.  
  448.  
  449. <rcommand> q beendet DeliTracker. Dieser Shortcut gilt für beide Fenster.
  450.  
  451.  
  452. ============================== Preferences ===========================
  453.  
  454. Wenn das Kontrollfenster offen ist, gelangen Sie entweder mit dem dazu-
  455. gehörigen Shortcut oder durch Klicken auf das '?' - Gadget in das Setup
  456. Fenster. Nun können Sie alle wichtigen Einstellungen vornehmen. Wählen
  457. Sie dazu einen beliebigen Player im Playerrequester an. Darauf werden im
  458. PlayerInfo-Feld alle verfügbaren Informationen über diesen Players
  459. angezeigt.
  460.  
  461. ADD            - Lädt den angewählten Player und legt den Pfad für
  462.               externe Player fest. Ein schon geladener Player
  463.               gleichen Namens wird allerdings nur dann durch den
  464.               neuen Player ersetzt, falls seine Versionsnummer
  465.               kleiner als die des neu geladenen Players ist.
  466.  
  467. DEL            - Löscht den selektierten Player, d.h. sein Speicher
  468.               wird freigegeben. Interne Player können zwar ebenfalls
  469.               gelöscht werden, jedoch wird deren Speicher nicht
  470.               freigegeben.
  471.  
  472. Filter            - siehe Filter Voreinstellung
  473.  
  474. Quick            - siehe Quick Voreinstellung
  475.  
  476. Random            - siehe Random Voreinstellung
  477.  
  478. Songend            - siehe Songend Voreinstellung
  479.  
  480. Append            - siehe Append Voreinstellung
  481.  
  482. Time            - siehe Timeout Voreinstellung
  483.  
  484. Load Config        - Eine Konfigurationsdatei laden und auswerten.
  485.  
  486. Save Config        - Schreibt alle aktuellen Einstellungen und die Modul-
  487.               liste in eine Konfigurationsdatei.
  488.  
  489. Save List        - Schreibt nur die aktuelle Modulliste in eine
  490.               Konfigurationsdatei.
  491.  
  492. Config Player        - Falls vorhanden, wird die spezifische Konfigurations-
  493.               routine des angewählten Players aufgerufen.
  494.  
  495. OK            - Schließt das Setup-Fenster.
  496.  
  497. Sie können das Playerdirectory auch angeben, indem sie den Pfad in das
  498. Stringgadget (links neben ADD) eingeben.
  499.  
  500.  
  501. ================================== Rexx ==============================
  502.  
  503. Bei eckigen Klammern [...] kann ein Argument angegeben werden, bei
  504. spitzen Klammern <...> muß es angegeben werden.
  505.  
  506.  
  507. DeliTracker stellt als 'Functionhost' folgende Kommandos zur Verfügung:
  508.  
  509. quit            - beendet DeliTracker
  510.  
  511. filter <BOOL>        - Schaltet den Filter ab, falls die angegebene Zahl
  512.               gleich 0 ist, ansonsten wird der Filter eingeschaltet.
  513.  
  514. quickstart <BOOL>    - Schaltet die Quickstart-Funktion ab, falls die
  515.               angegebene Zahl gleich 0 ist, ansonsten wird der
  516.               Quickstart eingeschaltet.
  517.  
  518. random <BOOL>        - Schaltet Randomplay aus, wenn BOOL = 0, ansonsten
  519.               wird Randomplay eingeschaltet
  520.  
  521. songend <BOOL>        - Schaltet die Songend Option ab, wenn BOOL = 0, sonst
  522.               werden eintreffende Songend Signale beachtet.
  523.  
  524. append <BOOL>        - Ist BOOL = 0 wird der Appendmodus deaktiviert, ansonsten
  525.               aktiviert.
  526.  
  527. timeout <SECS>        - Timeout wird auf die angegebene Zeitspanne (SECS) in
  528.               Sekunden gesetzt. Bei SECS = 0 wird diese Option
  529.               abgeschaltet.
  530.  
  531. volume <VOL>        - Setzt Volume auf <VOL> (Bereich von VOL: 0 - 64)
  532.  
  533. balance <BAL>        - Setzt Balance auf <BAL>, 0 ist default, -64 nur Links,
  534.               64 nur Rechts (Bereich von BAL: -64 bis 64)
  535.  
  536. forward            - Nächstes Pattern spielen
  537.  
  538. backward        - Vorheriges Pattern spielen
  539.  
  540. nextsong        - Nächsten Song spielen
  541.  
  542. prevsong        - Vorherigen Song spielen
  543.  
  544. nextsubsong        - Nächsten Subsong spielen
  545.  
  546. prevsubsong        - Vorherigen Subsong spielen
  547.  
  548. faster            - Abspielgeschwindigkeit erhöhen
  549.  
  550. slower            - Abspielgeschwindigkeit erniedrigen
  551.  
  552. loadconfig [DATEI]    - Konfigdatei [DATEI] laden wenn [DATEI] angegeben
  553.               wurde, sonst Requester für 'Konfigdatei laden'
  554.               öffnen.
  555.  
  556. saveconfig [DATEI]    - Konfiguration und Modulliste in [DATEI] sichern,
  557.               wenn [DATEI] angegeben wurde, sonst entsprechenden
  558.               Requester öffnen.
  559.  
  560. savelist [DATEI]    - Modulliste in [DATEI] sichern, wenn [DATEI]
  561.               angegeben wurde, sonst entsprechenden Requester
  562.               öffnen.
  563.  
  564. loadplayer [PLAYER]    - Lädt den angegebenen Player, ansonsten wird der
  565.               Requester zum Player-Laden geöffnet.
  566.  
  567. deleteplayer <NUMMER>    - Entfernt den Player mit der angegebenen Nummer aus
  568.               der Playerliste.
  569.               Bei diesem Kommando ist allerdings zu beachten, daß
  570.               die Module des gelöschten Players ab sofort nicht
  571.               mehr erkannt werden.
  572.  
  573. configplayer <NUMMER>    - Ruft die Konfigurationsroutine des dazugehörigen
  574.               Players auf.
  575.  
  576. playpause        - Der aktuell spielende Song wird alternierend gespielt
  577.               und angehalten.
  578.  
  579. stop            - Stoppt den aktuell spielenden Song.
  580.  
  581. playmod [MODUL]        - Falls [MODUL] angegeben, wird es geladen und abspielt,
  582.               sofern ein Player es erkennt. Ansonsten öffnet sich
  583.               der Filerequester zur Dateiauswahl.
  584.  
  585. eject            - entfernt den derzeitigen Song aus dem Speicher.
  586.  
  587. openmainwin        - Öffnet das Kontrollfenster
  588.  
  589. closemainwin        - Schließt das Kontrollfenster (jetzt kann DeliTracker
  590.               nur noch von REXX aus gesteuert werden).
  591.  
  592. openprefswin        - Öffnet das Setup-Fenster
  593.  
  594. closeprefswin        - Schließt das Setup-Fenster
  595.  
  596.  
  597. status    <group> <dependent> - group kann entweder p, m oder g sein.
  598.  
  599.     p :    Player
  600.  
  601. <dependent>  =    <playernum> <cmd>
  602.  
  603.            <cmd>        Bedeutung    und    Returnwert
  604.  
  605.         nam        Playername        String
  606.         cre        Creatorname        String
  607.         ver        Versionsnummer        Zahl
  608.         vol        Lautstärke veränderbar    0/1
  609.         bal        Balance veränderbar    0/1
  610.         jmp        Patternjump verfügbar    0/1
  611.         spd        Playspeed regelbar    0/1
  612.         sub        Subsong verfügbar    0/1
  613.         cfg        Player konfigurierbar    0/1
  614.         pck        Supports Packed Mods    0/1
  615.  
  616.     g :    Global
  617.  
  618. <dependent>  =    <cmd>
  619.  
  620.            <cmd>        Bedeutung    und    Returnwert
  621.  
  622.         ver        DeliTracker Version    Zahl
  623.         dir        Playerverzeichnis    String
  624.         num        Playeranzahl        Zahl
  625.         led        Filter-Zustand        0/1
  626.         qst        Quickstart-Zustand    0/1
  627.         rnd        Random-Zustand        0/1
  628.         app        Append-Zustand        0/1
  629.         end        Songend-Zustand        0/1
  630.         tim        Song-Timeout (sec)    Zahl
  631.         mwi        Kontrollfenster offen    0/1
  632.         pwi        Setup-Fenster offen    0/1
  633.         vol        derzeitige Lautstärke    Zahl
  634.         bal        derzeitige Balance    Zahl
  635.         ply        Song spielt        0/1
  636.  
  637.     m :    Module
  638.  
  639. <dependent>  =    <cmd>
  640.  
  641.            <cmd>        Bedeutung    und    Returnwert
  642.  
  643.         dir        Modulverzeichnis    String
  644.         fil        Modulname        String
  645.         pnr        aktiver Player        Zahl
  646.         max        Module in Modulliste    Zahl
  647.         num        Position in Modulliste    Zahl
  648.  
  649.  
  650. Dadurch kann DeliTracker voll von Rexx aus kontrolliert werden. Dies ist
  651. z.B. in Verbindung mit AmigaVision(TM) sehr nützlich.
  652.  
  653.  
  654. =============================== Problemecke ==========================
  655.  
  656. Symptom: Preferences Window läßt sich nicht öffnen.
  657. Überprüfen Sie, ob die Höhe des Screens auf dem DeliTracker läuft
  658. mindestens 190 Pixel + Titelbarhöhe ist. Bei einem zu schmalen oder zu
  659. niedrigen Screen läßt sich nämlich das Preferences Window nicht öffnen.
  660. Gegenmaßnahme: Verkleinern Sie den Font (topaz 8) oder benutzen Sie
  661. einen größeren Screen.
  662.  
  663. Ein Hinweis an alle Besitzer von Turbokarten (speziell 68030 und höher):
  664. Obwohl DeliTracker selbst problemlos auf schnelleren Prozessoren läuft,
  665. können sie bei einigen nicht sauber programmierten (externen) Playern zu
  666. Problemen führen. Das Timing mancher Abspielroutinen ist nämlich nur auf
  667. den 68000'er zugeschnitten und verursacht dann ein Klirren oder Auslassen
  668. von Noten. Zum Abstürzen der Player oder gar von DeliTracker selbst kann
  669. dies aber nicht führen. Auch in späteren Versionen von DeliTracker wird es
  670. voraussichtlich keine turbofeste Version solcher Player geben, da es oft
  671. fast unmöglich ist, diese entsprechend umzuprogrammieren.
  672.  
  673. Ein Hinweis an alle Besitzer von NTSC-Amigas und Amigas mit ECS-Denise:
  674. Prinzipiell spielen alle Player sowohl auf PAL- als auch auf NTSC-Geräten
  675. gleich schnell, da die Abspielgeschwindigkeit durch einen CIA-B Interrupt
  676. gesteuert wird. Einige (externe) Player benötigen jedoch unbedingt einen
  677. VBlank Interrupt. Da dessen Frequenz vom jeweiligen Videomodus abhängt,
  678. spielt ein solcher Player im Productivity-, NTSC- oder PAL-Modus
  679. unterschiedlich schnell.
  680. Screens mit 16 Farben in Hires oder mit 2 Farben in SuperHires b.z.w.
  681. Productivity benötigen ca. 60% aller Buszyklen des ChipRam. Wenn dann
  682. gleichzeitig ein besonders recheninternsiver Player (z.B. einer mit mehr
  683. als 4 Stimmen) aktiv ist, steht das System fast still und der jeweilige
  684. Player könnte mangels Rechenzeit falsch spielen.
  685.  
  686. Ein Hinweis an alle Modem-Besitzer:
  687. Wenn ein Player den internen DeliTracker Timer-Interrupt benutzt, treten
  688. keine Übertragungsfehler bei seriellen Transfers (getestet auf einem A500
  689. mit NComm bis 19200 Baud) auf. Bei Playern, die selbst einen TimerInterrupt
  690. generieren, sind derartige Störungen nicht auszuschließen.
  691.  
  692.  
  693. ================================= CREDITS ============================
  694.  
  695. Unser besonderer Dank gilt folgenden Personen:
  696.  
  697.  - unseren Testern Stefan, Daniel, Börnie und Manfred für ihre Bugreports
  698.    und guten Vorschläge.
  699.  
  700.  - Armin Sander (Oktalyzer) und Carsten Schlote (Sonic Arranger) für die
  701.    Anpassung Ihrer Soundsysteme.
  702.  
  703.  - allen auf #amiga (IRC), besonders Markus Illenseer für die Korrektur
  704.    der Docs.
  705.  
  706.  - Colin Fox and Bruce Dawson für die phantastische req.library.
  707.  
  708.  - und allen, die uns Replay-Routinen und Module geschickt haben.
  709.  
  710.  
  711. Auf folgenden Testkonfigurationen lief DeliTracker problemlos:
  712.  
  713.  - A500 KS1.3, 512k
  714.  - A500 KS1.2, 1MB
  715.  - A500 KS1.3, 1MB (Chip)
  716.  - A500 KS1.2, 2.3MB
  717.  - A500 KS1.2, 2.5MB & Harddisk
  718.  - A500+ KS2.04, 1MB & Harddisk
  719.  - A2000 KS1.2, 1MB
  720.  - A2000 KS1.3, 1MB & Harddisk
  721.  - A2000 KS1.3, 3MB (1MB Chip) & Harddisk
  722.  - A2500 KS1.3, 5MB (1MB Chip) & Harddisk
  723.  - A2500 KS2.04 9MB (1 MB Chip) & Harddisk
  724.  - A3000 KS1.3, 10MB & Harddisk
  725.  - A3000 KS2.04, 10MB & Harddisk
  726.  
  727.  
  728. ======================================================================
  729.  
  730. Falls Sie irgendwelche BUGS finden, Vorschläge oder Bemerkungen über
  731. dieses Programm haben, oder ein neues Soundsystem geschrieben haben
  732. lassen Sie es mich wissen.
  733.  
  734.                    Frank Riffel
  735.                 Merkstr. 27
  736.                   8129 Wessobrunn
  737.                   Germany
  738.  
  739.